home *** CD-ROM | disk | FTP | other *** search
/ Workbench Design / WB Collection.iso / workbench werkzeuge / memory & system tools / scout / docs / english / scout.guide (.txt) < prev    next >
Amigaguide Document  |  1996-04-07  |  56KB  |  1,424 lines

  1. @database scout.guide
  2. @Master scout.texi
  3. @Width 72
  4. This is the AmigaGuide
  5.  file scout.guide, produced by Makeinfo-1.55 from 
  6. the input file scout.texi.
  7. @Node Main "scout.guide"
  8. @Next "Introduction"
  9.                              Scout 37.105
  10.                              Release 2.2
  11.                             User's Manual
  12.                   Copyright (C) 1994 Andreas Gelhausen
  13.  @{" Introduction " Link "Introduction"}          What is `Scout'?
  14.  @{" Copyright " Link "Copyright"}             What you should know for distributing
  15.  @{" Disclaimer " Link "Disclaimer"}            NO WARRANTY
  16.  @{" Giftware " Link "Giftware"}              `Scout' is giftware
  17.  @{" System Requirements " Link "System Requirements"}   What your system should have
  18.  @{" Installation " Link "Installation"}          Installing `Scout'
  19.  @{" Using Scout " Link "Using Scout"}           How to use `Scout'
  20.  @{" Scout and AmiTCP " Link "Scout and AmiTCP"}      `Scout' as `AmiTCP' service
  21.  @{" Scout without MUI " Link "Scout without MUI"}     `MUI' is not necessary!
  22.  @{" Options " Link "Options"}               You can set some variables.
  23.  @{" Commands " Link "Commands"}              ARexx and shell commands
  24.  @{" Updates " Link "Updates"}               How to get updates
  25.  @{" Credits " Link "Credits"}               Thanks are going to...
  26.  @{" Author Info " Link "Author Info"}           How to reach the author
  27.  @{" Index " Link "Index"}                 Contents index
  28. @EndNode
  29. @Node "Introduction" "scout.guide/Introduction"
  30. @Next "Copyright"
  31. @Prev "Main"
  32. @Toc "Main"
  33. What is Scout?
  34. ==============
  35.    `Scout' is a tool that allows you to monitor your computer system.
  36. It displays many different things -- like tasks, ports, assigns,
  37. expansion boards, resident commands, interrupts, etc.  -- and you can
  38. perform some certain actions on them.
  39.    For example you can freeze tasks, close windows and screens, release
  40. semaphores or remove locks, ports and interrupts.
  41. Through `AmiTCP' it's also possible to use `Scout' as an TCP/IP service.
  42.    Since version 2.0 of `Scout' you can use nearly all implemented
  43. functions through shell parameters. Therefore it's not necessary to
  44. install `MUI' for using `Scout', but you will need `MUI', if you want
  45. to use `Scout' with its graphical user interface.
  46. @EndNode
  47. @Node "Copyright" "scout.guide/Copyright"
  48. @Next "Disclaimer"
  49. @Prev "Introduction"
  50. @Toc "Main"
  51. Copyright
  52. =========
  53.    Scout 37.105 (Release 2.2) - Copyright (C) 1994 by Andreas Gelhausen,
  54. all rights reserved.
  55.    `Scout' is a giftware program and you are only allowed to freely
  56. distribute it, if you let this archive unchanged.  No part of this
  57. archive is allowed to be distributed with commercial software without a
  58. written permission of the author.
  59. @EndNode
  60. @Node "Disclaimer" "scout.guide/Disclaimer"
  61. @Next "Giftware"
  62. @Prev "Copyright"
  63. @Toc "Main"
  64. Disclaimer
  65. ==========
  66.    No warranties are made for this program. All use is at your own risk.
  67. No liability or responsibility is assumed for any damages occured
  68. during the usage of `Scout'. You have been warned.
  69. @EndNode
  70. @Node "Giftware" "scout.guide/Giftware"
  71. @Next "System Requirements"
  72. @Prev "Disclaimer"
  73. @Toc "Main"
  74. Giftware
  75. ========
  76.    `Scout' 37.105 is giftware. If you like and use this program, you
  77. are welcome to appreciate my programming efforts by sending me a little
  78. present -- thanks a lot in advance!  =:^)
  79. @EndNode
  80. @Node "System Requirements" "scout.guide/System Requirements"
  81. @Next "MUI"
  82. @Prev "Giftware"
  83. @Toc "Main"
  84. System Requirements
  85. ===================
  86. `Scout' only requires Amiga operating system version 2.04.
  87.    If you want to use `Scout's' graphical user interface, you also have
  88. to install `MUI' version 2.1 or higher.  See also
  89. @{"MUI and where you can get it" Link "MUI"}.
  90.    The TCP/IP features of `Scout' are only available, if you have
  91. installed the version 4.0 of `AmiTCP'.  See also
  92. @{"AmiTCP and where you can get it" Link "AmiTCP"}.
  93. @EndNode
  94. @Node "MUI" "scout.guide/MUI"
  95. @Next "AmiTCP"
  96. @Prev "System Requirements"
  97. @Toc "System Requirements"
  98. MUI - MagicUserInterface
  99. ========================
  100.              (C) Copyright 1993/94 by Stefan Stuntz
  101.    MUI is a system to generate and maintain graphical user interfaces.
  102. With the aid of a preferences program, the user of an application has
  103. the ability to customize the outfit according to his personal taste.
  104.    MUI is distributed as shareware. To obtain a complete package
  105. containing lots of examples and more information about registration
  106. please look for a file called `muiXXusr.lha' (XX means the latest
  107. version number) on your local bulletin boards or on public domain disks.
  108.    If you want to register directly, feel free to send DM 30.- or US$
  109. 20.- to
  110.                         Stefan Stuntz
  111.                    Eduard-Spranger-Stra
  112.                         80935 M
  113. nchen
  114.                            GERMANY
  115. @EndNode
  116. @Node "AmiTCP" "scout.guide/AmiTCP"
  117. @Next "Installation"
  118. @Prev "MUI"
  119. @Toc "System Requirements"
  120. AmiTCP
  121. ======
  122.    `AmiTCP' is a TCP/IP protocol stack for the Amiga. The demo version
  123. 4.0 (or higher) should be available in greater public domain
  124. collections or on the AmiNet. Ask your preferred Amiga dealer.  =:^)
  125. @EndNode
  126. @Node "Installation" "scout.guide/Installation"
  127. @Next "Using Scout"
  128. @Prev "AmiTCP"
  129. @Toc "Main"
  130. Installing Scout
  131. ================
  132.    You only have to copy the program `scout' and the data file
  133. `scout.data' to your favourite directory and then you can start it. The
  134. file `scout.data' includes data of expansion boards.
  135. @EndNode
  136. @Node "Using Scout" "scout.guide/Using Scout"
  137. @Next "Assigns"
  138. @Prev "Installation"
  139. @Toc "Main"
  140. How to use Scout
  141. ****************
  142.    This chapter describes the usage of `Scout' through its graphical
  143. user interface. This graphical user interface is based on the `Magic
  144. User Interface' (`MUI') and `MUI' have to be installed in your system,
  145. if you want to use `Scout' trough windows and so on.
  146.    If you don't like `MUI', you should see @{"Scout without MUI" Link "Scout without MUI"}.
  147. If you start the program, you will get following window:
  148.             
  149. --------------------------------------------------
  150.             | @{"   Libraries   " link "Libraries"     } @{"    Devices    " link "Devices"   } @{"   Resources   " link "Resources"        } |
  151.             | @{"     Tasks     " link "Tasks"         } @{"     Ports     " link "Ports"     } @{" Resident Cmds " link "Resident Cmds"    } |
  152.             | @{"  Expansions   " link "Expansions"    } @{"    Memory     " link "Memory"    } @{"   Residents   " link "Residents"        } |
  153.             | @{"    Assigns    " link "Assigns"       } @{"     Locks     " link "Locks"     } @{" Mounted Devs  " link "Mounted Devs"     } |
  154.             | @{" InputHandlers " link "InputHandlers" } @{"  Interrupts   " link "Interrupts"} @{"    Vectors    " link "Vectors"          } |
  155.             | @{"     Fonts     " link "Fonts"         } @{"  Semaphores   " link "Semaphores"} @{"    Windows    " link "Windows"          } |
  156.             
  157. --------------------------------------------------
  158.    Every gadget you see represents a certain kind of system structures.
  159.    Click one of these gadgets and another window will be opened with a
  160. list of the structure type that is indicated on the pressed gadget.
  161.      *Example:* Press the task gadget and you will get a window with
  162.      the list of tasks and processes.
  163.    You can also select these functions by pressing the underlined key
  164. you see on each gadget or by using the right mousebutton menu.
  165.    If you wish to handle/remove a given structure, you should know what
  166. you do.
  167.      *Warning:* Wrong handling of the showed structures can crash your
  168.      system. At the worst you will lose your data.
  169. *Please note:* You should not be surprised, if you don't find a certain
  170. detail information in this manual, because it's to much work to explain
  171. each element of all the structures you could see in this program.
  172.    Many books are written about these things and if you want to have
  173. more information about them, you should have a look in the specialized
  174. literature.
  175. @EndNode
  176. @Node "Assigns" "scout.guide/Assigns"
  177. @Next "Devices"
  178. @Prev "Using Scout"
  179. Assigns
  180. =======
  181.    This type of structure assigns a logical name to a directory.
  182.    If you assign the directory `dh0:data/documents' the logical name
  183. `texts:', you will also be able to choose a file FILENAME in that
  184. directory with the path `texts:FILENAME'.
  185. Column items
  186. ------------
  187. `Address'
  188.      Address of the assign structure.
  189. `Name'
  190.      Logical name of a directory
  191. `Path'
  192.      Here you will find the path of the directory.
  193. Actions
  194. -------
  195. `Update'
  196.      Selecting this gadget updates the list of assigns.
  197. `Print'
  198.      This function allows you to send the list of `Assigns' to printer
  199.      or a selected file.
  200. `Remove'
  201.      The selected assign will be removed with this function.
  202. `Exit'
  203.      The `Assigns' window will be closed.
  204. @EndNode
  205. @Node "Devices" "scout.guide/Devices"
  206. @Next "Expansions"
  207. @Prev "Assigns"
  208. Devices
  209. =======
  210.    A device is -- like a library (see @{"Libraries" Link "Libraries"}) -- a collection of
  211. functions/procedures, which have to do certain jobs.
  212.    E.g. the `trackdisk.device' includes functions for the floppy disk
  213. handling.
  214. Column items
  215. ------------
  216. `Address'
  217.      Address of the device structure
  218. `ln_Name'
  219.      Name of a device
  220. `ln_Pri'
  221.      Priority of a device
  222. `OpenC'
  223.      This element shows how often the device was opened.
  224. `RPC'
  225.      `RPC' means `RAM Pointer Count' and shows how many jump addresses
  226.      of the device point into RAM.  In this way many programs -- like
  227.      the `setpatch' command from Commodore -- patch the system.
  228.      Many viruses patch the system in this way too, but don't panic now.
  229.      If you check your system in regular intervals with a current virus
  230.      killer, it should be out of danger.
  231.      If the whole program code of the device is located in RAM, you will
  232.      find a dash (minus sign) here, because in this case it's
  233.      unimportant how many jump addresses point into RAM.
  234. `ln_Type'
  235.      Type of this structure (usually `device')
  236. Actions
  237. -------
  238. `Update'
  239.      If you select this gadget, the list of devices will be updated.
  240. `Print'
  241.      This function allows you to send the list of `Devices' to printer
  242.      or a selected file.
  243. `Remove'
  244.      The selected device will be removed with this function provided
  245.      that no program uses this device anymore and the `OpenC' is zero.
  246. `Priority'
  247.      Herewith the priority of the device can be changed.  A little
  248.      window will be opened, that asks you for a new priority.  Through
  249.      the new priority it can happen that the device gets a new place in
  250.      the device list.
  251. `More'
  252.      Another window will be opened and you will see more informations
  253.      about the selected device.
  254.      You will have the same effect, if you doubleclick an element of the
  255.      device list.
  256. `Exit'
  257.      The `Devices' window will be closed.
  258. @EndNode
  259. @Node "Expansions" "scout.guide/Expansions"
  260. @Next "Fonts"
  261. @Prev "Devices"
  262. Expansions
  263. ==========
  264.    In this list you will find all your expansion boards (graphic boards,
  265. memory expansions and so on).
  266. Column items
  267. ------------
  268. `BoardAddr'
  269.      Usually you will find the ROM of the card here.  If this address
  270.      points into RAM, the card is a memory expansion.
  271. `BoardSize'
  272.      If the entry belongs to a memory expansion, the size of the memory
  273.      is displayed here.  Otherwise it's the ROM size of the card.
  274. `Manufacturer'
  275.      ManufacturerID, assigned by Commodore
  276. `Product'
  277.      Productnumber, assigned by the manufacturer of the board
  278. `Serial#'
  279.      Serialnumber of the card (usually unused)
  280. Actions
  281. -------
  282. `Print'
  283.      This function allows you to send the list of `Expansions' to
  284.      printer or a selected file.
  285. `More'
  286.      Now a window will be opened, that includes more informations about
  287.      the selected expansion board.
  288.      Doubleclick an element of the `Expansions' list and you will have
  289.      the same effect.
  290. `Exit'
  291.      The `Expansions' window will be closed.
  292. Unknown expansion boards
  293. ------------------------
  294.    If you select an expansion board by selecting its list item, you will
  295. get the name of the manufacturer and the card in the textfield you find
  296. below the list, provided that I have known these data at compiling.
  297.    If no information is available in this textfield or the given
  298. information is wrong, you should send me the following data, please.
  299.      1. ManufacturerID (Manufacturer)
  300.      2. ProductID (Product)
  301.      3. Name of the company
  302.      4. Name of your expansion card
  303.    If you send me these data, the next version of file `scout.data'
  304. will include your expansion boards. Please be as precise you can.
  305. @EndNode
  306. @Node "Fonts" "scout.guide/Fonts"
  307. @Next "InputHandlers"
  308. @Prev "Expansions"
  309. Fonts
  310. =====
  311. This function will show you all fonts existing in your system.
  312. Column items
  313. ------------
  314. `YSize'
  315.      Vertical size of the font
  316. `Count'
  317.      Here you can see how many programs use the font.
  318. `Type'
  319.      `ROMFONT' means the font is located in ROM and `DISKFONT' means
  320.      the font was loaded from disk/harddisk.
  321. `Name'
  322.      Name of the font
  323. Actions
  324. -------
  325. `Update'
  326.      The list of fonts will be updated.
  327. `Print'
  328.      This function allows you to send the list of `Fonts' to printer or
  329.      a selected file.
  330. `Close'
  331.      The font will be closed by using this function.
  332. `Remove'
  333.      It is possible to remove a font from system, provided that no
  334.      program uses it and it's no `ROMFONT'.
  335. `Exit'
  336.      The `Fonts' window disappears.
  337. @EndNode
  338. @Node "InputHandlers" "scout.guide/InputHandlers"
  339. @Next "Interrupts"
  340. @Prev "Fonts"
  341. InputHandlers
  342. =============
  343.    Input handlers take care of all user input arriving in system
  344. (pressed keys, mouseclicks, inserted disks, etc.). They stand one
  345. behind the other like on a production line and analyze the user input.
  346. The input handler with the highest priority gets the `events' first and
  347. if it doesn't know how to react on these `events', the second input
  348. handler gets them, and so on.
  349.    Usually the system input handler has a priority of 50.  Every input
  350. handler, that wants to get the user input before the system, must have
  351. a higher priority.
  352. Column items
  353. ------------
  354. `ln_Name'
  355.      Name of the input handler
  356. `ln_Pri'
  357.      Its priority
  358. `is_Data'
  359.      This address points to some data needed by the input handler.
  360. `is_Code'
  361.      The program code starts here.  If the code is located in RAM, the
  362.      address is of different color.  Otherwise you can find the code in
  363.      ROM.  Some viruses install an input handler in system.  In this
  364.      case the `is_Code' address points into RAM, but many other
  365.      programs uses input handlers, too.  Don't panic!
  366. Actions
  367. -------
  368. `Update'
  369.      The list of input handlers will be updated when you select this
  370.      gadget.
  371. `Print'
  372.      This function allows you to send the list of `InputHandlers' to
  373.      printer or a selected file.
  374. `Remove'
  375.      Removes an input handler from system.
  376. `Priority'
  377.      Changes the priority of an input handler.
  378. `Exit'
  379.      The window will be closed.
  380. @EndNode
  381. @Node "Interrupts" "scout.guide/Interrupts"
  382. @Next "Libraries"
  383. @Prev "InputHandlers"
  384. Interrupts
  385. ==========
  386.    Interrupts are important events the computer system has to react on.
  387. It exists a list of interrupt routines for each interrupt type. If a
  388. certain interrupt occurs, all these interrupt routines will be called.
  389. During their execution the running program will be interrupted.
  390. Column items
  391. ------------
  392. `ln_Name'
  393.      Name of the interrupt
  394. `ln_Pri'
  395.      Its priority
  396. `is_Data'
  397.      At this address you find the data of the interrupt.
  398. `is_Code'
  399.      Address of the interrupt code.  If this address points into RAM,
  400.      it's of a different color.
  401. `NUM'
  402.      This number represents the type of event the interrupt routine is
  403.      called on.  The `IntName' you find in the interrupt detail window
  404.      gives you a little bit more information about it.
  405.      *Example:* Number 5 means that the interrupt is called at every
  406.      vertical blank interval.
  407. Actions
  408. -------
  409. `Update'
  410.      The list of interrupts will be updated.
  411. `Print'
  412.      This function allows you to send the list of `Interrupts' to
  413.      printer or a selected file.
  414. `Remove'
  415.      If the interrupt is a server you can remove it from system.  An
  416.      interrupt handler can't be removed by `Scout'.
  417.      If you call `avail flush' and the audio.device isn't used, the
  418.      interrupt handlers of the audio.device will be removed.
  419. `More'
  420.      Now a window will be opened that includes more details of the
  421.      interrupt.
  422. `Exit'
  423.      Selecting this gadget will close the `Interrupts' window.
  424. @EndNode
  425. @Node "Libraries" "scout.guide/Libraries"
  426. @Next "Locks"
  427. @Prev "Interrupts"
  428. Libraries
  429. =========
  430.    A library is a collection of functions/procedures, which have to do
  431. certain jobs. E.g. the `graphics.library' includes routines for
  432. graphical display.
  433. Column items
  434. ------------
  435. `Address'
  436.      Adress of the library structure
  437. `ln_Name'
  438.      Name of a library
  439. `ln_Pri'
  440.      Priority of a library
  441. `OpenC'
  442.      Here you see, how often the library was opened.
  443. `RPC'
  444.      `RPC' means `RAM Pointer Count' and shows how many jump addresses
  445.      of the library point into RAM.  In this way many programs -- like
  446.      the `setpatch' command from Commodore -- patch the system.
  447.      Many viruses patch the system in this way too, but don't panic now.
  448.      If you check your system in regular intervals with a current virus
  449.      killer, it should be out of danger.
  450.      If the whole program code of the library is located in RAM, you
  451.      will find a dash (minus sign) here, because in this case it's
  452.      unimportant how many jump addresses point into RAM.
  453. `ln_Type'
  454.      Type of this structure (usually `library')
  455. Actions
  456. -------
  457. `Update'
  458.      The list of libraries will be updated.
  459. `Print'
  460.      This function allows you to send the list of `Libraries' to
  461.      printer or a selected file.
  462. `Remove'
  463.      The selected library will be removed with this function provided
  464.      that no program uses this library anymore and the `OpenC' is zero.
  465.      Some libraries can't be removed from system without a reset.  So
  466.      you shouldn't wonder about it, if this happens.
  467. `Close'
  468.      A library must be closed by all programs, if you want to remove it
  469.      from system. In this case the `OpenC' is zero.
  470.      If you select this function, you will be asked, how often you want
  471.      to close it. You can choose between `Once' and `All'.
  472.      Select `All' and the library will so often be closed till the
  473.      `OpenC' is zero.
  474. `Priority'
  475.      Herewith the priority of the library can be changed.  A little
  476.      window will be opened, that asks you for a new priority.  Through
  477.      the new priority it can happen that the library gets a new place
  478.      in the list of libraries.
  479. `More'
  480.      A window will be opened that includes more details of the library.
  481. `Exit'
  482.      Selecting this gadget will close the `library' window.
  483. @EndNode
  484. @Node "Locks" "scout.guide/Locks"
  485. @Next "Memory"
  486. @Prev "Libraries"
  487. Locks
  488. =====
  489.    A lock structure shows you, that a program reads from or perhaps
  490. write into a file or a directory.  With this type of structure the
  491. system prevents, that a file will be deleted while another program gets
  492. some data from it.
  493. Column items
  494. ------------
  495. `Access'
  496.      Here you can see the type of access.  This could be `READ',
  497.      `WRITE' or `OWN'.  `OWN' stands for a lock `Scout' created to get
  498.      the elements of this list.
  499. `Path'
  500.      Path of the file or directory
  501. Actions
  502. -------
  503. `Update'
  504.      The list of `Locks' will be updated.
  505. `Print'
  506.      This function allows you to send the list of `Locks' to printer or
  507.      a selected file.
  508. `Remove'
  509.      A lock will be removed through dos.library's `UnLock()' function.
  510. `Pattern'
  511.      If you give `Scout' a pattern, only the locks with a matching path
  512.      will be shown.
  513. `Exit'
  514.      The `Locks' window will be closed.
  515. @EndNode
  516. @Node "Memory" "scout.guide/Memory"
  517. @Next "Mounted Devs"
  518. @Prev "Locks"
  519. Memory
  520. ======
  521.    In this list you will find the segments of your memory.  At least you
  522. will find an entry for your chip memory.
  523. Column items
  524. ------------
  525. `ln_Name'
  526.      Name of the memory segment (e.g. `chip memory')
  527. `ln_Pri'
  528.      Priority of memory
  529. `mh_Lower'
  530.      First address of memory
  531. `mh_Upper'
  532.      Last address of memory
  533. Actions
  534. -------
  535. `Print'
  536.      This function allows you to send the list of the memory segments to
  537.      printer or a selected file.
  538. `Priority'
  539.      This function allows you to change the priority of a memory
  540.      segment.  The memory segment with the highest priority will be
  541.      preferred from system, provided that no certain type of memory is
  542.      demanded.
  543. `More'
  544.      Another window will be opened. This window includes more
  545.      information about the memory segment.
  546. `Exit'
  547.      The window will be closed.
  548. @EndNode
  549. @Node "Mounted Devs" "scout.guide/Mounted Devs"
  550. @Next "Ports"
  551. @Prev "Memory"
  552. Mounted Devices
  553. ===============
  554.    In this list you will find all your devices like disk drives, printer
  555. devices, etc.
  556. Column items
  557. ------------
  558. `Name'
  559.      Name of the device
  560. `Unit'
  561.      Unit number
  562. `Heads'
  563.      Number of heads
  564. `Cyl'
  565.      Number of cylinders
  566. `State'
  567.      The state shows you for example, if a disk is in drive.
  568. `DiskType'
  569.      Type of a disk (e.g. OFS (OldFileSystem), FFS (FastFileSystem),
  570.      ...)
  571. `Handler or Device'
  572.      The handler or the device you find here has to manage the stream of
  573.      data from and to the device.
  574. Actions
  575. -------
  576. `Update'
  577.      The list will be updated.
  578. `Print'
  579.      This function allows you to send the list of `Mounted Devs' to
  580.      printer or a selected file.
  581. `Exit'
  582.      The window will be closed.
  583. @EndNode
  584. @Node "Ports" "scout.guide/Ports"
  585. @Next "Resident Cmds"
  586. @Prev "Mounted Devs"
  587. Ports
  588. =====
  589. Programs are able to communicate together through ports.
  590. Column items
  591. ------------
  592. `Address'
  593.      Here you will find the port structure.
  594. `ln_Name'
  595.      Name of port
  596. `ln_Pri'
  597.      Priority of port
  598. `mp_SigTask'
  599.      The task is communicating through the port.
  600. Actions
  601. -------
  602. `Update'
  603.      The ports list will be updated.
  604. `Print'
  605.      This function allows you to send the list of `Ports' to printer or
  606.      a selected file.
  607. `Remove'
  608.      The port will be removed.
  609. `Priority'
  610.      Herewith the port priority can be changed.
  611. `Exit'
  612.      The `Ports' window will be closed.
  613. @EndNode
  614. @Node "Resident Cmds" "scout.guide/Resident Cmds"
  615. @Next "Residents"
  616. @Prev "Ports"
  617. Resident Commands
  618. =================
  619.    This list includes all resident commands. That means all commands you
  620. find in ROM and the commands you made `resident' through the `resident'
  621. command.
  622. Positions and sizes of their hunks you will find here, too.
  623. Column items
  624. ------------
  625. `Name'
  626.      Name of the command
  627. `UseCount'
  628.      Here you can see, how often a command was being executed at the
  629.      time the list was build.
  630. `Lower'
  631.      First address of hunk in memory
  632. `Upper'
  633.      Last address of hunk in memory
  634. `Size'
  635.      Size of hunk (upper - lower - 8 bytes overhead)
  636. Actions
  637. -------
  638. `Update'
  639.      The list of `Resident Commands' will be updated.
  640. `Print'
  641.      This function allows you to send the list of `Resident Commands' to
  642.      printer or a selected file.
  643. `Remove'
  644.      The selected command will be removed with this function provided
  645.      that no program uses this command anymore and the `UseCount' is
  646.      zero.
  647. `Exit'
  648.      The window disappears.
  649. @EndNode
  650. @Node "Residents" "scout.guide/Residents"
  651. @Next "Resources"
  652. @Prev "Resident Cmds"
  653. Residents
  654. =========
  655.    Resident modules are reset-protected segments (code and data).  In
  656. the list of `Residents' you usually find libraries, devices and
  657. resources.  A programmer has the possibility to make his own programs
  658. reset-protected.  He has to initialize a resident structure for it and
  659. then he can link the program through the kick-vectors (see @{"Vectors" Link "Vectors"}) to
  660. the list of the resident modules.  The residents you linked to system
  661. are usually located in RAM and are of a different color.
  662.    If you find a resident module that points into RAM and you don't know
  663. which program has created it, you should start your favourite virus
  664. detector and let it check your memory.  Many viruses prefer this way to
  665. travel around.
  666. Column items
  667. ------------
  668. `Address'
  669.      At this address the resident module is located.
  670. `ln_Name'
  671.      Name of the resident module
  672. `rt_Pri'
  673.      Priority
  674. `rt_IdString'
  675.      Identity string of the resident module.
  676. Actions
  677. -------
  678. `Update'
  679.      The list of `Residents' will be updated.
  680. `Print'
  681.      This function allows you to send the list of `Residents' to
  682.      printer or a selected file.
  683. `More'
  684.      Selecting this gadget opens a new window with more information
  685.      about the selected resident module.
  686. `Exit'
  687.      The `Residents' window will be closed.
  688. @EndNode
  689. @Node "Resources" "scout.guide/Resources"
  690. @Next "Semaphores"
  691. @Prev "Residents"
  692. Resources
  693. =========
  694.    Usually a resource is -- like a library (see @{"Libraries" Link "Libraries"}) -- a
  695. collection of functions/procedures, which have to do certain jobs.
  696.    E.g. the `filesystem.resource' includes functions for the filesystem
  697. handling.
  698. Column items
  699. ------------
  700. `Address'
  701.      Address of the resource structure
  702. `ln_Name'
  703.      Name of a resource
  704. `ln_Pri'
  705.      Priority of a resource
  706. `OpenC'
  707.      This element shows how often the resource was opened.
  708. `RPC'
  709.      `RPC' means `RAM Pointer Count' and shows how many jump addresses
  710.      of the resource point into RAM.  In this way many programs -- like
  711.      the `setpatch' command from Commodore -- patch the system.
  712.      Many viruses patch the system in this way too, but don't panic now.
  713.      If you check your system in regular intervals with a current virus
  714.      killer, it should be out of danger.
  715.      If the whole program code of the resource is located in RAM, you
  716.      will find a dash (minus sign) here, because in this case it's
  717.      unimportant how many jump addresses point into RAM.
  718. `ln_Type'
  719.      Type of this structure (usually `resource')
  720. Actions
  721. -------
  722. `Update'
  723.      The list of `Resources' will be updated.
  724. `Print'
  725.      This function allows you to send the list of `Resources' to
  726.      printer or a selected file.
  727. `Remove'
  728.      The selected resource will be removed with this function, provided
  729.      that no program uses it anymore and the `OpenC' is zero.
  730. `Priority'
  731.      Herewith the priority of the resource can be changed. A small
  732.      window will be opened, that asks you for a new priority. Through
  733.      the new priority it can happen that the resource gets a new
  734.      position in the list of resources.
  735. `More'
  736.      Select this gadget and you get a new window with more information
  737.      about the selected resource.
  738. `Exit'
  739.      The `Resources' window will be closed.
  740.    *Please note:* If you should find three dashes (minus signs) at
  741. `OpenC' and/or `RPC', the resource has no typical library structure.
  742. This happens for example at the `FileSystem.resource'.
  743. @EndNode
  744. @Node "Semaphores" "scout.guide/Semaphores"
  745. @Next "Tasks"
  746. @Prev "Resources"
  747. Semaphores
  748. ==========
  749.    The use of semaphores is a way of single-threading critical
  750. sections.  For example only one program is allowed to use the printer
  751. at one time, otherwise the texts would be mixed.
  752. Column items
  753. ------------
  754. `ln_Name'
  755.      Name of a semaphore
  756. `Nest'
  757.      This item counts how often the semaphore has been obtained by the
  758.      owner task.
  759. `Queue'
  760.      This counter shows you, how many programs want to obtain the
  761.      semaphore.
  762. `Owner'
  763.      Here you will find the name of the task that owns the semaphore.
  764. Actions
  765. -------
  766. `Update'
  767.      The list of `Semaphores' will be updated.
  768. `Print'
  769.      This function allows you to send the list of `Semaphores' to
  770.      printer or a selected file.
  771. `Obtain'
  772.      This function is used to gain access to a semaphore.  The `NestCnt'
  773.      will be increased at one by this call.
  774. `Release'
  775.      Herewith you can make a signal semaphore available to others.
  776. `Exit'
  777.      The `Semaphores' window will be closed.
  778. @EndNode
  779. @Node "Tasks" "scout.guide/Tasks"
  780. @Next "Vectors"
  781. @Prev "Semaphores"
  782. Tasks
  783. =====
  784.    In this window you find a list of all tasks and processes being in
  785. system. Each program you start will be executed as a task or process.
  786. Column items
  787. ------------
  788. `ln_Name'
  789.      Name of the task/process
  790. `ln_Type'
  791.      Type of the structure (`task' or `process')
  792. `ln_Pri'
  793.      Priority of the task/process
  794. `NUM'
  795.      If a non detaching program was started from shell, you will find
  796.      here the number of the process. Programs you started from
  797.      Workbench have a dash here.
  798. `State'
  799.      Here you see the state of the task or process. You will find
  800.      Scout's own process on the top of the list with a `run' at this
  801.      place, because this process is always running when it gets the
  802.      task list.
  803.      `ready' means the task wants to work, but it's interrupted by the
  804.      execution of another task.
  805.      A task that is waiting for a certain signal is in the state
  806.      `wait'. In this case it doesn't need processing time.
  807. `SigWait'
  808.      Signalmask the task is waiting for.
  809. Actions
  810. -------
  811. `Print'
  812.      This function allows you to send the list of `Tasks' to printer or
  813.      a selected file.
  814. `Freeze'
  815.      With this function you freeze the selected task. It can still be
  816.      found in the list of tasks, but it gets no processing time from
  817.      system.
  818.           *Warning:* If you try to freeze tasks essential to the system
  819.           like `input.device', you should have saved all important
  820.           data, cause a RESET is the only way out!
  821. `Activate'
  822.      A frozen task can be activated here.
  823. `CPU'
  824.      Here you will find a text field and a cycle gadget. This text field
  825.      displays -- dependent on the state of the cycle gadget -- the CPU
  826.      load in percent.
  827.      For the cycle gadget you can choose between three states:
  828.     `off'
  829.           In this case the CPU load won't be displayed. If you select
  830.           another state, `Scout' will patch some system functions to
  831.           calculate the CPU load of all tasks.
  832.     `full'
  833.           If you select this state, `Scout' sets the real cpu load to
  834.           100%.  That means the total of the CPU loads of all tasks and
  835.           processes will be 100%. Therefore nothing will be displayed
  836.           in the text field.
  837.     `in %'
  838.           `Scout' starts a task named `
  839.  Scout's cheat task 
  840.           calculate the real CPU load and it will be displayed in the
  841.           text field.
  842. `Secs'
  843.      This string gadget allows you to set the intervall time for
  844.      updating of the CPU load display.
  845. `Update'
  846.      The list will be updated.
  847. `Remove'
  848.      A task will be removed from the list.  You should prefer the freeze
  849.      function, if you perhaps need this task again.
  850.      See also `Break'!
  851. `Signal'
  852.      If you select a signal mask, it will be send to the task.
  853. `Break'
  854.      A signal mask that includes the signals CTRL-C and CTRL-D will be
  855.      send to the task you selected.  Many tasks and processes end, if
  856.      they receive these signals.
  857. `Priority'
  858.      The priority of a task can be changed with this function.
  859. `More'
  860.      Selecting this gadget will open another window that displays more
  861.      informations about the task or the process.
  862. `Exit'
  863.      The window will be closed.
  864. @EndNode
  865. @Node "Vectors" "scout.guide/Vectors"
  866. @Next "Windows"
  867. @Prev "Tasks"
  868. Vectors
  869. =======
  870. Actions
  871. -------
  872. `Update'
  873.      The displayed vectors will be updated.
  874. `Print'
  875.      This function allows you to send the list of `Vectors' to printer
  876.      or a selected file.
  877. `Exit'
  878.      The window will be closed.
  879. Reset Vectors
  880. -------------
  881.    A program can make itself reset-protected by using the reset vectors.
  882. If the vectors are unused, they have a value of zero. The programs
  883. which use the Kick-Vectors (KickTagPtr, KickMemPtr and KickCheckSum)
  884. can also be found in the list of resident structures.  See also
  885. @{"Residents" Link "Residents"}.
  886. Auto Vector Interrupts
  887. ----------------------
  888.    In a computer system with a MC68000 processor you will find the seven
  889. `Auto Vector Interrupts' from address $64 to address $7c. Higher
  890. processors (MC68010, etc.) have the VBR (Vector Base Register) that
  891. allows you to move the interrupt table to FAST-MEM. The system will be
  892. a little bit faster then. `Scout' uses the VBR if it exists.
  893. Interrupt Vectors
  894. -----------------
  895.    Here you see 16 interrupt vectors (IntVecs). These vectors are
  896. located in the `ExecBase' (base structure of the exec.library).
  897. @EndNode
  898. @Node "Windows" "scout.guide/Windows"
  899. @Next "Scout and AmiTCP"
  900. @Prev "Vectors"
  901. Windows
  902. =======
  903.    All screens with the windows opened on them are listed here. Screens
  904. are of a different color as windows.
  905. Column items
  906. ------------
  907. `Pos(x,y)'
  908.      x and y position of the screen/window
  909. `Size(x,y)'
  910.      x and y size of the screen/window
  911. `Title'
  912.      Title of the screen/window
  913. Actions
  914. -------
  915. `Update'
  916.      The list will be updated.
  917. `Print'
  918.      This function allows you to send the list of `Windows' to printer
  919.      or a selected file.
  920. `Close'
  921.      With this function it is possible to close screens and/or windows.
  922.      If you close a screen, all windows on it will be closed too.
  923. `To Front'
  924.      The selected screen/window will be popped to front.
  925. `More'
  926.      If you select this gadget another window will be opened that
  927.      displays more informations about the window or the screen.
  928. `Exit'
  929.      The window will be closed.
  930. @EndNode
  931. @Node "Scout and AmiTCP" "scout.guide/Scout and AmiTCP"
  932. @Next "Scout without MUI"
  933. @Prev "Windows"
  934. @Toc "Main"
  935. Scout and AmiTCP
  936. ================
  937.    This section will show you what you have to do for using `Scout' as
  938. a TCP/IP service through `AmiTCP'. Nearly all functions of `Scout' can
  939. also be used via `AmiTCP'.
  940.    Now some knowledge will be assumed. If you don't know, what kind of
  941. program `AmiTCP' represents, you should read `AmiTCP's' user's manual
  942. before. (See also @{"AmiTCP" Link "AmiTCP"}.)
  943.    If you have installed `AmiTCP', you can use `Scout' as client and
  944. server. Except the installed programs of `AmiTCP' you don't need
  945. another program for using `Scout' on networks.
  946.    If you want to make your computer available for other systems on the
  947. network, you have to do following two steps:
  948.   1. Add the line `scout 6543/tcp' to file `AmiTCP:db/services'.
  949.   2. Now please add the line `scout stream tcp nowait root dh0:scout'
  950.      to file `AmiTCP:db/inetd.conf'. Make sure that the path at the end
  951.      of this line is the right path for `scout'.
  952.    That's it! If you start `AmiTCP' now, your computer is available for
  953. other systems through using the options `HOST', `USER' and `PASSWORD'.
  954.       *Example:* If I want perform some actions on some system
  955.      structures of my own system for example, I have to start `Scout'
  956.      through something like:
  957.      1> scout HOST crash.north.de USER atte PASSWORD secret
  958.    If you leave out option `PASSWORD', you will be asked for the
  959. correct password through the `password:' prompt. In this case nobody
  960. can see your password, because it won't be displayed in shell.
  961.    If you don't use option `USER', `AmiTCP' takes the username that is
  962. actually available in system.
  963.    The usage of `AmiTCP' doesn't provide the installation of `MUI'. All
  964. of `Scout's' shell commands (see also @{"Commands" Link "Commands"}) can be used via network
  965. through `AmiTCP'.
  966.       *Example:* If I want to get the task list of my system, I have to
  967.      use something like:
  968.      1> scout HOST crash.north.de USER atte PASSWORD secret Tasks
  969.    You and all other users must always identify themselves through
  970. their usernames (option `USER') and their passwords (option `PASSWORD').
  971. It's also possible to allow or deny certain systems the usage of some
  972. services through the file `AmiTCP:db/inet.access'. See also the user's
  973. manual of `AmiTCP'.
  974.    If you want to get more informations about the implemented options
  975. and commands, you should also see @{"Options" Link "Options"} and @{"Commands" Link "Commands"}.
  976. @EndNode
  977. @Node "Scout without MUI" "scout.guide/Scout without MUI"
  978. @Next "Options"
  979. @Prev "Scout and AmiTCP"
  980. @Toc "Main"
  981. Scout without MUI
  982. =================
  983.    Nearly all through the graphical user interface available functions
  984. of `Scout' are also available via shell. Therefore you don't really
  985. need `MUI' for using `Scout'. But if you want to use `Scout's'
  986. graphical user interface, you must have `MUI' in your system.
  987. @EndNode
  988. @Node "Options" "scout.guide/Options"
  989. @Next "Commands"
  990. @Prev "Scout without MUI"
  991. @Toc "Main"
  992. Options
  993. *******
  994.    There are some options for `Scout' which you can use, when you start
  995. the program.  The following options are available from shell and as
  996. tool types from Workbench.
  997. `ICONIFIED'
  998.      *Usage:* `ICONIFIED'
  999.      If this option is activ, `Scout' starts iconified.
  1000. `PORTNAME'
  1001.      *Usage:* `PORTNAME'=PORTNAME
  1002.      The name of Scout's ARexx port can be changed into PORTNAME.
  1003.      Without this option the ARexx port is called `SCOUT.X'. The `X'
  1004.      stands for a decimal number that will be incremented, if a so
  1005.      called port already exists.
  1006. `TOOLPRI'
  1007.      *Usage:* `TOOLPRI'=VALUE
  1008.      This option allows you to change the priority of Scout's process
  1009.      into VALUE.
  1010. `STARTUP'
  1011.      *Usage:* `STARTUP'=SCRIPTNAME
  1012.      You can choose an ARexx script SCRIPTNAME, that will be executed
  1013.      at the start of `Scout'. In this way you can open more than only
  1014.      the main window. If for example the ARexx script includes the
  1015.      command `OpenWindow Tasks', the task list window will always be
  1016.      opened when the program starts.
  1017.      (See also @{"ARexx port" Link "Commands"}.)
  1018. `INTERVALTIME'
  1019.      *Usage:* `INTERVALTIME'=SECONDS
  1020.      This options allows you to save your preferred update time for the
  1021.      list of tasks.  (See also @{"Secs" Link "Tasks"}.)
  1022. `CPUDISPLAY'
  1023.      *Format:* `CPUDISPLAY'=VALUE
  1024.      Through the variable VALUE you can select the state of the `CPU'
  1025.      cycle gadget you find in the `Tasks' window.  (See also @{"CPU" Link "Tasks"}.)
  1026.         * `1'  means  `CPU: full'
  1027.         * `2'  means  `CPU: in %'
  1028. `HOST'
  1029.      *Format:* `HOST'=HOSTNAME
  1030.      This options allows you to specify the system (HOSTNAME) you want
  1031.      to manipulate via network through `AmiTCP'.
  1032. `USER'
  1033.      *Format:* `USER'=USERNAME
  1034.      You have to use this option to identify yourself by using `Scout'
  1035.      as a TCP/IP service.
  1036. `PASSWORD'
  1037.      *Format:* `PASSWORD'=PASSWORD
  1038.      Without a password `Scout' can't connect to another system via
  1039.      network. This option allows you to set the correct password.
  1040. `COMMAND'
  1041.      *Format:* `COMMAND'=COMMANDLINE
  1042.      Nearly all of `Scout's' implemented functions are available from
  1043.      shell through this option. You don't need the `COMMAND' key to use
  1044.      this option. (See also @{"Commands" Link "Commands"}.)
  1045. `SORTTASKSBYNAME'
  1046.      *Format:* `SORTTASKSBYNAME'
  1047.      If this option is used, `Scout' sorts the list of tasks by name.
  1048. `SINGLEWINDOWS'
  1049.      *Format:* `SINGLEWINDOWS'
  1050.      Some users don't like to handle the many windows of Scout. This
  1051.      option solves the problem of too many windows. If this option is
  1052.      selected, only one list window and only one detail window is
  1053.      opened at a time.
  1054. @EndNode
  1055. @Node "Commands" "scout.guide/Commands"
  1056. @Next "Updates"
  1057. @Prev "Options"
  1058. @Toc "Main"
  1059. Scout's commands via ARexx and shell
  1060. ************************************
  1061. `Scout' supports two kinds of commands:
  1062.   1. commands only available from shell
  1063.   2. commands available from ARexx and shell
  1064. ARexx port
  1065. ----------
  1066.    It's a feature of `MUI' to give each application its own ARexx port.
  1067. Therefore `Scout' also has an ARexx port that usually has the name
  1068. `SCOUT.X'. The `X' stands for a decimal number that will be
  1069. incremented, if a so called port already exists.
  1070.    You will find the name of `Scout's' ARexx port in the window you
  1071. get, if you select the `Project/About' menu.
  1072. Using tasknames:
  1073. ----------------
  1074.    If a task or a process was started from shell and hasn't detached
  1075. itself, you will find the name of the command being executed, where
  1076. usually the taskname is displayed.  The real name of those tasks
  1077. usually is something like `Background CLI', but such a taskname isn't
  1078. useful.
  1079.      *Example:* If you start a non detaching task like
  1080.      `DH0:Debug/Sushi' from shell, you will see `DH0:Debug/Sushi' as
  1081.      taskname.
  1082.    Some ARexx commands need a taskname as parameter. You have to select
  1083. those from CLI started self detaching tasks by using their command
  1084. names like `Scout' displays them in the lists of tasks.
  1085. Commands only available from shell
  1086. ==================================
  1087. `Help'
  1088.      *Format:* `Help'
  1089.      This command is the most important one and it doesn't need
  1090.      parameters.  If you try `Help', `Scout' prints a list of all
  1091.      available commands to shell.  =:^)
  1092.    Now 18 commands follow. These commands allow the user to get all
  1093. lists of system structures from shell. Therefore you only need to
  1094. install `MUI' for using `Scout's' graphical user interface.
  1095.    Each of the following commands has a shortened form that stands
  1096. behind the command in parentheses.
  1097.      `Assigns' (a), `Commands' (c), `Devices' (d), `Expansions' (e),
  1098.      `Fonts' (f), `InputHandlers' (h), `Interrupts' (i), `Libraries'
  1099.      (l), `Memory' (m), `Mounts' (n), `Locks' (o), `Ports' (p),
  1100.      `Residents' (r), `Semaphores' (s), `Tasks' (t), `Resources' (u),
  1101.      `Vectors' (v) und `Windows' (w)
  1102.       *Example:* To get the list of ports, you only have to use `scout
  1103.      ports' or `scout p' from shell.
  1104. Commands available from ARexx and shell
  1105. =======================================
  1106. `FindTask'
  1107.      *Usage:* `FindTask' TASK
  1108.      This command allows you to check, if task TASK exists in system or
  1109.      not. The result is the address of the task TASK, if it has been
  1110.      found. TASK can be the name or the address of a task.
  1111. `FreezeTask'
  1112.      *Usage:* `FreezeTask' TASK
  1113.      The task TASKNAME will be frozen. After that it will still be
  1114.      found in system's task list, but then it doesn't need processing
  1115.      time.  You can choose the name or the address of a task for TASK.
  1116. `ActivateTask'
  1117.      *Usage:* `ActivateTask' TASK
  1118.      If task TASK was frozen, it will be activated, otherwise an error
  1119.      occured. TASK is again a task's name or an address.
  1120. `RemoveTask'
  1121.      *Usage:* `RemoveTask' TASK
  1122.      This command removes the task TASK. It's lost forever.
  1123. `BreakTask'
  1124.      *Usage:* `BreakTask' TASK
  1125.      `Scout' sends the task TASK a certain signal mask that includes
  1126.      the signals CTRL-C and CTRL-D. Many programs support these signals
  1127.      and finish themselves, if they receive one of them.
  1128. `SignalTask'
  1129.      *Usage:* `SignalTask' TASK HEXSIGNAL
  1130.      This command allows you to send a signal HEXSIGNAL to the task
  1131.      TASK. The signal must specified as a hexadecimal number.
  1132.      *Example:*
  1133.           SendSignal 'scout' 0x001000
  1134.      sends task `scout' a CTRL-C and after that `Scout' ends.
  1135. `SetTaskPri'
  1136.      *Usage:* `SetTaskPri' TASK PRIORITY
  1137.      The task TASK gets a new priority (PRIORITY).
  1138. `RemovePort'
  1139.      *Usage:* `RemovePort' PORT
  1140.      The port PORT will be removed from `Scout'. PORT can be the name
  1141.      of a port or its address.
  1142. `GetLockNumber'
  1143.      *Usage:* `GetLockNumber' LOCKPATTERN
  1144.      This command returns the number of locks which have paths matching
  1145.      to the pattern LOCKPATTERN.
  1146.      *Example:* Use the command
  1147.           GetLockNumber 'WORK:Utilities/#?'
  1148.      and you will know, how many locks are currently used for files in
  1149.      the directory `WORK:Utilities/'.
  1150. `RemoveLocks'
  1151.      *Usage:* `RemoveLocks' LOCKPATTERN
  1152.      Use this command and all locks which have paths matching to the
  1153.      pattern LOCKPATTERN will be removed.  (See also `GetLockNumber'.)
  1154. `RemoveLock'
  1155.      *Format:* `RemoveLock' LOCKADDRESS
  1156.      The lock at adress LOCKADDRESS will be removed.
  1157. `FindNode'
  1158.      *Usage:* `FindNode' NODETYPE NODENAME
  1159.      This command allows you to find a certain node. You only have to
  1160.      know its name (NODENAME) and its type (NODETYPE).
  1161.      NODETYPE can have following values:  `LIBRARY', `DEVICE',
  1162.      `RESOURCE', `MEMORY', `SEMAPHORE', `PORT' or `INPUTHANDLER'.
  1163.      *Example:* If you want to get the address of the `disk.resource'
  1164.      you must use:
  1165.           FindNode RESOURCE 'disk.resource'
  1166. `GetPriority'
  1167.      *Usage:* `GetPriority' NODEADDRESS
  1168.      This command allows you to check the priority of a certain node
  1169.      structure. This includes all following structure types:  tasks,
  1170.      libraries, devices, resources, ports, residents, input handlers,
  1171.      interrupts, semaphores and the elements of the memory list.
  1172.      You only have to know the address (NODEADDRESS) of that structure.
  1173.      *Example:* The following ARexx commands store the priority of your
  1174.      chip memory in the variable `pri':
  1175.           FindName MEMORY 'chip memory'
  1176.           addr = result
  1177.           GetPriority addr
  1178.           pri = result
  1179. `SetPriority'
  1180.      *Usage:* `SetPriority' NODETYPE NODENAME
  1181.      If you want to change the priority of the node NODENAME, you can
  1182.      use this command.  Again NODETYPE can have following values:
  1183.      `LIBRARY', `DEVICE', `RESOURCE', `MEMORY', `SEMAPHORE', `PORT' or
  1184.      `INPUTHANDLER'.
  1185. `CloseLibrary'
  1186.      *Format:* `CloseLibrary' LIBRARY
  1187.      The library LIBRARY will be closed once. LIBRARY can be the name
  1188.      of the library or its address.
  1189. `RemoveLibrary'
  1190.      *Format:* `RemoveLibrary' LIBRARY
  1191.      The library LIBRARY will be removed, if no program uses it.
  1192. `RemoveDevice'
  1193.      *Format:* `RemoveDevice' DEVICE
  1194.      The selected device DEVICE will be removed. For DEVICE use the
  1195.      name or the address of the device.
  1196. `RemoveResource'
  1197.      *Format:* `RemoveResource' RESOURCE
  1198.      The resource RESOURCE will be removed.
  1199. `ObtainSemaphore'
  1200.      *Format:* `ObtainSemaphore' SEMAPHORE
  1201.      This command allows you to obtain the given semaphore. SEMAPHORE
  1202.      can be the semaphore's name or address.
  1203. `ReleaseSemaphore'
  1204.      *Format:* `ReleaseSemaphore' SEMAPHORE
  1205.      The semaphore SEMAPHORE will be once released.
  1206. `RemoveSemaphore'
  1207.      *Format:* `RemoveSemaphore' SEMAPHORE
  1208.      You are able to remove the semaphore SEMAPHORE by using this
  1209.      command.
  1210. `RemoveInputhandler'
  1211.      *Format:* `RemoveInputhandler' INPUTHANDLER
  1212.      The input handler INPUTHANDLER selected through name or address
  1213.      will be removed.
  1214. `FindResident'
  1215.      *Usage:* `FindResident' RESIDENT
  1216.      This command returns the address of the resident structure
  1217.      RESIDENT.
  1218. `FindInterrupt'
  1219.      *Usage:* `FindInterrupt' INTERRUPTNAME
  1220.      The address of the interrupt INTERRUPTNAME will be returned.
  1221. `RemoveInterrupt'
  1222.      *Format:* `RemoveInterrupt' INTERRUPTNAME
  1223.      The interrupt you have selected through INTERRUPTNAME will be
  1224.      removed.
  1225. `FlushDevs'
  1226.      *Usage:* `FlushDevs'
  1227.      All not used devices will be removed. The used memory will be
  1228.      freed.
  1229. `FlushFonts'
  1230.      *Usage:* `FlushFonts'
  1231.      If a diskfont is in memory, but no program uses it, it will be
  1232.      removed.
  1233. `FlushLibs'
  1234.      *Usage:* `FlushLibs'
  1235.      All not used libraries will be removed. The used memory will be
  1236.      freed.
  1237. `FlushAll'
  1238.      *Usage:* `FlushAll'
  1239.      This function includes `FlushDevs', `FlushFonts' and `FlushLibs'.
  1240.      All not used devices, libraries and fonts will be removed and the
  1241.      used memory will be freed.
  1242. `ClearResetVectors'
  1243.      *Usage:* `ClearResetVectors'
  1244.      The six reset vectors will be cleared, if you select this function
  1245.      (see @{"Vectors" Link "Vectors"}).
  1246. `PopToFront'
  1247.      *Usage:* `PopToFront' TITLE
  1248.      This command allows you to pop a screen or window to front. You
  1249.      only have to know its (TITLE).
  1250. `CloseWindow'
  1251.      *Usage:* `CloseWindow' WINDOWTITLE
  1252.      This command closes the window that is specified through its title
  1253.      (WINDOWTITLE).
  1254. `CloseScreen'
  1255.      *Usage:* `CloseScreen' SCREENTITLE
  1256.      If you select this command, the screen (SCREENTITLE) will be
  1257.      closed with all its windows.
  1258. `CloseFont'
  1259.      *Format:* `CloseFont' ADDRESS
  1260.      The font at address ADDRESS will be closed once.
  1261. `RemoveFont'
  1262.      *Format:* `RemoveFont' ADDRESS
  1263.      This command removes the font at address ADDRESS, if it's not used
  1264.      by any program.
  1265. `RemoveCommand'
  1266.      *Format:* `RemoveCommand' ADDRESS
  1267.      `Scout' makes the resident command at address ADDRESS not resident.
  1268. `RemoveAssign'
  1269.      *Format:* `RemoveAssign' NAME
  1270.      With this command you're able to remove the assign NAME.
  1271. `RemoveAssignList'
  1272.      *Format:* `RemoveAssignList' NAME ADDRESS
  1273.      This command removes the directory at address ADDRESS from assign
  1274.      NAME. You will find the address of that directory in the list of
  1275.      assigns.
  1276. `OpenWindow'
  1277.      *Usage:* `OpenWindow' WINDOWID
  1278.      All windows you get if you select a gadget of `Scout's' main
  1279.      window, can be opened with this command.  The WINDOWID is the same
  1280.      text you find on the main window gadgets.
  1281.      *Example:*
  1282.           OpenWindow 'Mounted Devs'
  1283.      will open the window with the list of mounted devices.
  1284. @EndNode
  1285. @Node "Updates" "scout.guide/Updates"
  1286. @Next "Credits"
  1287. @Prev "Commands"
  1288. @Toc "Main"
  1289. How to get updates
  1290. ==================
  1291.    The newest version of `Scout' should always be available in the
  1292. "DEEP THOUGHT BBS" (see below), on AmiNet or Public Domain collections,
  1293. which are up-to-date.
  1294. Support BBS
  1295. ===========
  1296.      DEEP THOUGHT Bulletin Board System, Oldenburg, Germany
  1297.      
  1298.      Node 1
  1299.      +49-(0)441-383365   1200-21600 bps  v.32terbo, v.42bis
  1300.      
  1301.      Node 2
  1302.      +49-(0)441-383839   1200-19200 bps  v.32bis, v.42bis, ZyXEL
  1303.      
  1304.                      Node 1                Node 2
  1305.      FidoNet         2:2426/2020.0         2:2426/2021.0
  1306.      AmigaNet        39:170/204.0          39:170/205.0
  1307.      
  1308.      InterNet        cosinus@deepthought.north.de
  1309.      
  1310.      
  1311.      Both Nodes are 24 hours online every day.
  1312.      A FidoNet Mailer is running on both Nodes which accepts
  1313.      FidoNet Filerequests.
  1314.      
  1315.      Use the magic   SCOUT for the newest version of SCOUT
  1316.      or              FILES for a complete filelist
  1317. @EndNode
  1318. @Node "Credits" "scout.guide/Credits"
  1319. @Next "Author Info"
  1320. @Prev "Updates"
  1321. @Toc "Main"
  1322. Credits
  1323. =======
  1324.    Now I have to thank some people for supporting the development of
  1325. `Scout' on many different kinds:
  1326.    * Klaus `gizmo' Weber, he was always available to me and my many
  1327.      questions (not a few) during the programming of `Scout'.
  1328.    * Christian `cosinus' Stelter, he gave me the permission to use his
  1329.      many manuals.
  1330.    * Stefan Stuntz for his great `MagicUserInterface'
  1331.    * all bug reporting and feature requesting people: Kai `wusel'
  1332.      Siering, Martin Hauner, Peter Meyer, Karl `Charly' Skibinski,
  1333.      Michael `Mick' Hohmann, Thore B
  1334. ckelmann, Bernardo Innocenti, ...
  1335.      and last but not least
  1336.    * all the others I've forgotten for reporting bugs, sending
  1337.      expansion boards data and so on.
  1338. @EndNode
  1339. @Node "Author Info" "scout.guide/Author Info"
  1340. @Next "Index"
  1341. @Prev "Credits"
  1342. @Toc "Main"
  1343. How to reach the author
  1344. =======================
  1345.    If you have questions, suggestions, bug reports or anything else, you
  1346. can send electronic mails to:
  1347.               atte@crash.north.de (Andreas Gelhausen)
  1348.                                or
  1349.                     2:2426/2020.24  (on FidoNet)
  1350.    If it is not possible for you to use this way, you can send letters
  1351.                        Andreas Gelhausen
  1352.                        Graf Spee Str. 23b
  1353.                        26123 Oldenburg
  1354.                           - Germany -
  1355. That's it!  =:^)
  1356. @EndNode
  1357. @Node "Index" "scout.guide/Index"
  1358. @Prev "Author Info"
  1359. @Toc "Main"
  1360. Index
  1361. *****
  1362. @Index "Index"
  1363.  @{" AmiTCP " Link "AmiTCP"}                               AmiTCP
  1364.  @{" ARexx " Link "Commands"}                                Commands
  1365.  @{" ARexx port " Link "Commands"}                           Commands
  1366.  @{" Assigns " Link "Assigns"}                              Assigns
  1367.  @{" Author Info " Link "Author Info"}                          Author Info
  1368.  @{" Boards " Link "Expansions"}                               Expansions
  1369.  @{" Command " Link "Commands"}                              Commands
  1370.  @{" Command Line Options " Link "Options"}                 Options
  1371.  @{" Copyright " Link "Copyright"}                            Copyright
  1372.  @{" Credits " Link "Credits"}                              Credits
  1373.  @{" DEEP THOUGHT BBS " Link "Updates"}                     Updates
  1374.  @{" Device names, logical " Link "Assigns"}                Assigns
  1375.  @{" Devices " Link "Devices"}                              Devices
  1376.  @{" Disclaimer " Link "Disclaimer"}                           Disclaimer
  1377.  @{" DISKFONT " Link "Fonts"}                             Fonts
  1378.  @{" Expansions " Link "Expansions"}                           Expansions
  1379.  @{" Fonts " Link "Fonts"}                                Fonts
  1380.  @{" Giftware " Link "Giftware"}                             Giftware
  1381.  @{" Hardware " Link "Expansions"}                             Expansions
  1382.  @{" Input events " Link "InputHandlers"}                         InputHandlers
  1383.  @{" InputHandlers " Link "InputHandlers"}                        InputHandlers
  1384.  @{" Installation " Link "Installation"}                         Installation
  1385.  @{" Interrupts " Link "Interrupts"}                           Interrupts
  1386.  @{" Introduction " Link "Introduction"}                         Introduction
  1387.  @{" Legalities " Link "Copyright"}                           Copyright
  1388.  @{" Libraries " Link "Libraries"}                            Libraries
  1389.  @{" Locks " Link "Locks"}                                Locks
  1390.  @{" Logical device names " Link "Assigns"}                 Assigns
  1391.  @{" MagicUserInterface " Link "MUI"}                   MUI
  1392.  @{" Main Window " Link "Using Scout"}                          Using Scout
  1393.  @{" Manufacturer " Link "Expansions"}                         Expansions
  1394.  @{" Memory " Link "Memory"}                               Memory
  1395.  @{" Mounted Devices " Link "Mounted Devs"}                      Mounted Devs
  1396.  @{" MUI " Link "MUI"}                                  MUI
  1397.  @{" No Warranty " Link "Disclaimer"}                          Disclaimer
  1398.  @{" Options " Link "Options"}                              Options
  1399.  @{" Ports " Link "Ports"}                                Ports
  1400.  @{" Processes " Link "Tasks"}                            Tasks
  1401.  @{" RAM Pointer Count " Link "Devices"}                    Devices
  1402.  @{" Resident Commands " Link "Resident Cmds"}                    Resident Cmds
  1403.  @{" Residents " Link "Residents"}                            Residents
  1404.  @{" Resources " Link "Resources"}                            Resources
  1405.  @{" ROMFONT " Link "Fonts"}                              Fonts
  1406.  @{" RPC " Link "Devices"}                                  Devices
  1407.  @{" Screens " Link "Windows"}                              Windows
  1408.  @{" Semaphores " Link "Semaphores"}                           Semaphores
  1409.  @{" Support BBS " Link "Updates"}                          Updates
  1410.  @{" System Requirements " Link "System Requirements"}                  System Requirements
  1411.  @{" Tasknames " Link "Commands"}                            Commands
  1412.  @{" Tasks " Link "Tasks"}                                Tasks
  1413.  @{" TCP/IP " Link "AmiTCP"}                               AmiTCP
  1414.  @{" Tool Types " Link "Options"}                           Options
  1415.  @{" Updates " Link "Updates"}                              Updates
  1416.  @{" Using Scout " Link "Using Scout"}                          Using Scout
  1417.  @{" VBR " Link "Vectors"}                                  Vectors
  1418.  @{" Vectors " Link "Vectors"}                              Vectors
  1419.  @{" Vertical blank interrupt " Link "Interrupts"}             Interrupts
  1420.  @{" Warranty " Link "Disclaimer"}                             Disclaimer
  1421.  @{" What is Scout? " Link "Introduction"}                       Introduction
  1422.  @{" Windows " Link "Windows"}                              Windows
  1423. @EndNode
  1424.